Autogenerated HTML docs for v1.6.1.2-306-gc0f6f
diff --git a/git-push.html b/git-push.html index dd84101..df10c73 100644 --- a/git-push.html +++ b/git-push.html
@@ -352,22 +352,24 @@ </dt> <dd> <p> - The canonical format of a <refspec> parameter is - <tt>+?<src>:<dst></tt>; that is, an optional plus <tt>+</tt>, followed - by the source ref, followed by a colon <tt>:</tt>, followed by - the destination ref. + The format of a <refspec> parameter is an optional plus + <tt>+</tt>, followed by the source ref <src>, followed + by a colon <tt>:</tt>, followed by the destination ref <dst>. + It is used to specify with what <src> object the <dst> ref + in the remote repository is to be updated. </p> -<div class="para"><p>The <src> side represents the source branch (or arbitrary -"SHA1 expression", such as <tt>master~4</tt> (four parents before the -tip of <tt>master</tt> branch); see <a href="git-rev-parse.html">git-rev-parse(1)</a>) that you -want to push. The <dst> side represents the destination location.</p></div> -<div class="para"><p>The local ref that matches <src> is used -to fast forward the remote ref that matches <dst>. If -the optional leading plus <tt>+</tt> is used, the remote ref is updated -even if it does not result in a fast forward update.</p></div> +<div class="para"><p>The <src> is often the name of the branch you would want to push, but +it can be any arbitrary "SHA-1 expression", such as <tt>master~4</tt> or +<tt>HEAD</tt> (see <a href="git-rev-parse.html">git-rev-parse(1)</a>).</p></div> +<div class="para"><p>The <dst> tells which ref on the remote side is updated with this +push. Arbitrary expressions cannot be used here, an actual ref must +be named. If <tt>:</tt><dst> is omitted, the same ref as <src> will be +updated.</p></div> +<div class="para"><p>The object referenced by <src> is used to fast forward the ref <dst> +on the remote side. If the optional leading plus <tt>+</tt> is used, the +remote ref is updated even if it does not result in a fast forward +update.</p></div> <div class="para"><p><tt>tag <tag></tt> means the same as <tt>refs/tags/<tag>:refs/tags/<tag></tt>.</p></div> -<div class="para"><p>A lonely <src> parameter (without a colon and a destination) pushes -the <src> to the same name in the destination repository.</p></div> <div class="para"><p>Pushing an empty <src> allows you to delete the <dst> ref from the remote repository.</p></div> <div class="para"><p>The special refspec <tt>:</tt> (or <tt>+:</tt> to allow non-fast forward updates) @@ -785,12 +787,12 @@ </p> </dd> <dt> -git push origin :experimental +git push origin HEAD </dt> <dd> <p> - Find a ref that matches <tt>experimental</tt> in the <tt>origin</tt> repository - (e.g. <tt>refs/heads/experimental</tt>), and delete it. + A handy way to push the current branch to the same name on the + remote. </p> </dd> <dt> @@ -805,6 +807,16 @@ </p> </dd> <dt> +git push origin HEAD:master +</dt> +<dd> +<p> + Push the current branch to the remote ref matching <tt>master</tt> in the + <tt>origin</tt> repository. This form is convenient to push the current + branch without thinking about its local name. +</p> +</dd> +<dt> git push origin master:refs/heads/experimental </dt> <dd> @@ -816,6 +828,15 @@ the ref name on its own will work. </p> </dd> +<dt> +git push origin :experimental +</dt> +<dd> +<p> + Find a ref that matches <tt>experimental</tt> in the <tt>origin</tt> repository + (e.g. <tt>refs/heads/experimental</tt>), and delete it. +</p> +</dd> </dl></div> </div> <h2 id="_author">Author</h2> @@ -833,7 +854,7 @@ </div> <div id="footer"> <div id="footer-text"> -Last updated 2009-01-22 03:38:32 UTC +Last updated 2009-02-01 06:35:53 UTC </div> </div> </body>
